home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / mint / utils / gdb35bin.zoo / readme.st < prev   
Text File  |  1993-03-12  |  3KB  |  76 lines
  1. Hi everyone out there!
  2.  
  3. This is the *VERY FIRST* publication of my port of GDB 3.5 to the ATARI
  4. micros running MiNT!
  5.  
  6. IMPORTANT: GDB *WILL NOT* run under TOS, since it makes heavy use of
  7.            MiNT's/MultiTOS' procfs, signal handling etc.
  8.  
  9. Compiling GDB:
  10. The archive in which the sources are contained, looks exactly as the
  11. directories on my HD, so compiling is simply a matter of hitting
  12. 'make'. (You will have to use a file system that allows for large
  13. filenames, though. I use MINIX FS (thanx Stephen!).
  14.  
  15. I use GCC 2.3.3 on my TT, together with mintlib PL 30. You will have
  16. to copy some header files from $GNUINC to $GNUINC/sys, but you will
  17. see that while compiling... (If you get an endless loop in your
  18. headers, that is because of the headers in $GNUINC/sys #include the
  19. files in $GNUINC with the same names, but themselves are included
  20. from the sources dir by headers with the same name...)
  21.  
  22. Why 3.5?
  23.  
  24. Well, 3.5 is the *FIRST* GDB to be able to deal with C++, and as I'm
  25. a C++ programmer, I had to port this...
  26.  
  27. Differences to GDB 2.6 PL 18:
  28.  
  29. - the _stksize value is set in atariwait.c
  30.  
  31. - GDB uses the MiNT procfs for debugging, so GDB is a legal MiNT citizen.
  32.  
  33. - GDB still can't run a process more than once, though this release doesn't
  34.   complain. Be careful! (The reason is that the symbols have to be relocated,
  35.   and once this has happened the offset is !=0, so you can't do that twice.
  36.   Same story with breakpoints.)
  37.  
  38. - To debug a process, specify exec and symbol file as usual, BUT THEN SET A
  39.   BREAKPOINT BEFORE RUNNING THE DEBUGGED PROCESS!!! GDB *WILL NOT* STOP THE
  40.   PROCESS AUTOMATICALLY! I changed this behaviour to be compatible whith
  41.   the UN*X versions.
  42.  
  43. - GDB will report breakpoints as 'trace traps'. Don't bother. This will change
  44.   soon, I hope.
  45.  
  46. Known bugs:
  47.  
  48. - Attach/detach don't work in this release.
  49.  
  50. - the 'where' command sometimes bombs.
  51.  
  52. - FPU registers are not used nor displayed yet.
  53.  
  54. - terminal control doesn't work properly. That means, GDB will get stopped
  55.   when it tries to print out a message. To prevent this, use 'stty -tostop'
  56.   to turn off the default job control signals from the terminal.
  57.   Future versions will start the inferior in a seperate TTY (window).
  58.  
  59.   
  60.      
  61. I didn't carefully test this version. I just release it, because I have *VERY*
  62. limited time at the moment (because I'm involved in the german D2 spacelab mission)
  63. and thus can't predict when I will be able to get to work again.
  64.  
  65. I certainly welcome questions, bug reports (but more preferably bug fixes!!), pieces
  66. of work, comments, and suggestions.
  67.  
  68. PLEASE YOU GURUS OUT THERE, CONTRIBUTE TO MY WORK!!
  69.  
  70. Later, Joe
  71.  
  72. Contact me via E-MAIL:
  73.  
  74.        <Joerg.Hessdoerfer@EUROPA.rs.kp.dlr.de> (preferred)
  75.        <Hessdorf@SUN.ph-cip.uni-koeln.de>
  76.